home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor2 / tasc.doc < prev    next >
Text File  |  1995-03-31  |  4KB  |  102 lines
  1. (Comp.sources.hp48) 
  2. Item: 135 by higa@hubble.ifa.hawaii.edu [Jonathan T. Higa] 
  3. Subj: TASC v2.52 -- Turbo ->ASC and ASC-> 
  4. Date: 28 Jun 1992 
  5.  
  6. úÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ 
  7. 3 Mini-instructions: TASC filename. 3 
  8. àÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄù 
  9.  
  10. [Note: This program is awesome!  It'll save us all a ton of bucks in 
  11.  batteries!  There's no longer ANY need to upload or download files 
  12.  to/from your HP 48 in Wickes' ASC format.  TASC translates any HP 48 
  13.  binary file on a PC disk into ASC format, or an ASC file into binary 
  14.  format, on the PC.  This means that it's no longer necessary to 
  15.  include the ASC files on the Goodies Disks, thus freeing up several 
  16.  hundred K for more goodies!  And it's made it easier to add ASC files 
  17.  to comp.sources.hp48.  Thanx, Jonathan!  -Joe Horn & Chris Spell-] 
  18.  
  19. [Note 2:  You can also find out what the BYTES function on the HP 48 
  20.  would give for an HP 48 object on a computer disk, in either binary 
  21.  or ASC format, without uploading it!  Just type TASC filename > NUL. 
  22.  Nifty, huh?  -jkh-] 
  23.  
  24.  
  25. TASC(1)                  USER COMMANDS                    TASC(1) 
  26.  
  27.  
  28. NAMES 
  29.      tasc - translate HP48 binary files to and from ASC format 
  30.  
  31. SYNOPSIS 
  32.      tasc [-deiqr<let>] file [file] 
  33.  
  34. DESCRIPTION 
  35.      This program translates HP48 binary files to  and  from  ASC 
  36.      format.   It  should  be fully compatible with Bill Wickes's 
  37.      original ->ASC-> programs. 
  38.  
  39.      If you specify a translation mode,  you  must  specify  both 
  40.      source and target filenames. 
  41.      If you do not specify a translation mode, then the  type  of 
  42.      input  is  automatically  determined  from the source file's 
  43.      name.  If the source filename ends with  .asc,  then  it  is 
  44.      assumed  to  be  an  ASC file; if not, it is assumed to be a 
  45.      binary file.  If you do not specify a target filename,  then 
  46.      it  will  be  created  by adding or removing the .asc suffix 
  47.      from the source filename. 
  48.  
  49. OPTIONS 
  50.      -d   Force ASC->bin (ASC decoding) mode. 
  51.  
  52.      -e   Force bin->ASC (ASC encoding) mode. 
  53.  
  54.      -i   Use stdin  in  ASC->bin  /  stdout  in  bin->ASC  mode. 
  55.           Ignored by auto-translation mode. 
  56.  
  57.      -q   Quiet mode.  Suppress the status reports. 
  58.  
  59.      -rlet 
  60.           Generate files for ROM revision let.  The  default  ROM 
  61.           revision  is  E.   Currently  accepted  values are a-f. 
  62.           Ignored for bin->ASC translation. 
  63.  
  64. DIAGNOSTICS 
  65.      Returns 0 on success, 1 on error.   On  successful  exit,  a 
  66.      status  report  giving HP48 ROM Revision and object checksum 
  67.      and size is printed to the standard error, except  in  quiet 
  68.      mode. 
  69.  
  70. AUTHOR 
  71.      Jonathan T. Higa (jonhiga@phoenix.princeton.edu) 
  72.      As long as I can receive e-mail, please feel free  to  indi- 
  73.      cate needed changes. 
  74.  
  75. CAVEATS 
  76.      Version 2.52: 
  77.      Requires the ASCII character set. 
  78.      The target file is written DURING  translation.   Therefore, 
  79.      error  conditions  sometimes  leave  behind a useless target 
  80.      file. 
  81.      ASC files are scanned until a double-quote is found  at  the 
  82.      beginning  of a line, at which point decoding begins.  Don't 
  83.      put any spaces before this opening double-quote!  Note  that 
  84.      as  a  result  of this scanning, it is generally possible to 
  85.      pipe mail directly into "tasc -di filename." 
  86.  
  87. ACKNOWLEDGMENTS 
  88.      The   ASC   format   was    designed    by    Bill    Wickes 
  89.      (billw@hpcvdw.cv.hp.com).  The CRC algorithm used originally 
  90.      comes from the following text: 
  91.           da Cruz, Frank.  Kermit: A File Transfer Protocol. Bed- 
  92.           ford, MA: Digital Press, 1987. 
  93.      Background info on HP48 object structure was provided in the 
  94.      HP48  Tools  Manual;  the object prologue data was extracted 
  95.      from the document "HP48SX Internals," by  Derek  S.  Nickel. 
  96.      Thanks to Joe Horn for pointing out the appropriate files on 
  97.      the EduCalc Goodies Disks; thanks also for  finding  several 
  98.      serious bugs which didn't come up in preliminary testing. 
  99.  
  100.  
  101. Sun Release 4.1     Last change: 1992 June 19                   2 
  102.